﻿<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<!-- saved from url=(0029)http://www.helpandmanual.com/ -->
<head> 
   <title>Custom settings</title> 
   <!-- Template design (c) copyright 2008-2009 by Tim Green and EC Software -->
   <meta name="generator" content="Help &amp; Manual" /> 
   <meta name="keywords" content="" />
   <meta name="description" content="Custom settings" />
   <meta name="copyright" content="© 2012 Kentico Software" /> 
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 
   <meta http-equiv="X-UA-Compatible" content="IE=EmulateIE7" />
   <link type="text/css" href="default.css" rel="stylesheet" /> 
   <link type="text/css" href="custom.css" rel="stylesheet" />

   <script type="text/javascript" src="jquery-1.3.2.min.js"></script>
   <script type="text/javascript" src="jquery.scrollTo-min.js"></script>
   <script type="text/javascript" src="nsh.js"></script>



         
   <!-- CSS set with project variables and local attributes --> 
   <style type="text/css" media="screen"> 
   body { background: #fff; } 
   #breadcrumbs {width: 100%; background-color: white; border-bottom: 1px solid #000; padding: 0px 0px 5px 15px;
   margin: 3px 0; font-size: 8pt; color: #000;}
   #breadcrumbs a { color: #000; text-decoration: none;}
   #breadcrumbs a:visited { color: #000; }
   #breadcrumbs a:hover { color: #098ae2; text-decoration: none; }
   .help-url { font-size: 10pt; font-family: Arial, Verdana, Helvetica, sans-serif; 
               color: #1f84e8; text-align: center; margin: 5px 20px 10px 0px; 
               padding-top: 14px; border-top: 1px solid #000;}
   .help-url a { color: #098ae2; text-decoration: none; }
   .help-url a:visited { color: #098ae2; }
   .help-url a:hover { color: #098ae2; text-decoration: underline; }
   .highlight {background: #ffff40;}
   .breadhead {padding: 5px 0px 0px 0px !important;}    
   #innerdiv   
   {   
   padding-left: 5px;
   }
   

   </style> 

<!-- Adjustment for IE -->
<!--[if lte IE 8]>
<style type="text/css">
.topichead { padding-right: 0; }
   
   
   	.breadhead {
	margin: 0;
	padding-right: 5px;
	}
   
   
</style>
<![endif]-->
   
<script type="text/javascript">
// Initialize the page 
addEvent(window, "load", nsrInit);
addEvent(window, "load", doResize);
addEvent(window, "resize", doResize);
addEvent(window, "load", toggleJump);

</script>


<script type="text/javascript">
function mailFB_custom() {
var headerText = unQuot("Feedback on: Kentico CMS 6.0 Context Help - Custom settings".replace('&nbsp;',''));
var fb1 = "mailto:" + escape('Kentico Support Team <support@kentico.com>') + "?subject=" + headerText;
var titlePath = unQuot("CMS Site Manager &gt; Development &gt; Custom settings &gt; Custom settings /");
var fb2 = "&body=Ref:%20" + titlePath + "%20ID:%20custom_settings_main%0A%0D%0A%0D" + unQuot("Dear Support Staff,") + "%0A%0D%0A%0D";
var fb = fb1 + fb2;
document.location.href=fb;
}
</script>
<script type="text/javascript">

  var _gaq = _gaq || [];
  _gaq.push(['_setAccount', 'UA-105987-4']);
  _gaq.push(['_setDomainName', '.kentico.com']);
  _gaq.push(['_trackPageview']);

  (function() {
    var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
    ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
    var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
  })();

</script>        
<script type="text/javascript" src="helpman_topicinit.js"></script>
<!-- Redirect browser to frame page if page is not in the content frame. -->
<script type="text/javascript">
<!--
if (location.search.lastIndexOf("toc=0")<=0) {
  if (parent.frames.length==0) { parent.location.href="index.html?custom_settings_main.htm"; }
  else { parent.quicksync('a2.4.5.2'); }
}
//-->
</script>
<script type="text/javascript" src="highlight.js"></script></head> 
<body onload="highlight();">
<div id="hmpopupDiv" style="visibility:hidden; position:absolute; z-index:1000; "></div>
<!--ZOOMSTOP-->

<div id="printheader">
<span id="printtitle">Kentico CMS 6.0 Context Help</span><br />
<p class="p_Heading1"><span class="f_Heading1">Custom settings</span></p>
</div>
<div id="idheader" style="border-bottom:1px solid #000;margin:0px 0px;"> 
<table id="breadtable" border="0" cellspacing="0" cellpadding="0" width="100%"> 
  <tr >
  <td align="left" class="breadhead" >
       <p id="breadcrumbs"><a href="mode_selection.htm"
        onmouseover="document.images.main.src='home_h.gif'" 
        onmouseout="document.images.main.src='home.gif'">
        <img name="main" src="home.gif" border="0" alt="Home topic" title="Home topic" /></a> 
        
        CMS Site Manager &gt; <a href="development.htm">Development</a> &gt; Custom settings:</p> 
  </td>
  </tr>
</table>
<table width="99%" border="0" cellspacing="0" cellpadding="0" id="headtable"> 

<!-- Script version of NavHeader -->
  <tr id="scriptNavHead" valign="middle" style="height: auto;"> 
    <td align="left" class="topichead" style="padding-left: 15px;"> 
    <p class="p_Heading1"><span class="f_Heading1">Custom settings</span></p>

    </td>
    <td align="center" width="20" class="idnav" valign="bottom">
     <a href="custom_settings_overview.htm"
        onmouseover="document.images.prev.src='button_prev_h.gif'" 
        onmouseout="document.images.prev.src='button_prev.gif'">
        <img name="prev" src="button_prev.gif" border="0" alt="Previous topic" title="Previous topic" /></a>
     
   </td>
   
   <td align="center" width="20" class="idnav" valign="bottom">
     <a href="development_custom_tables_overview.htm"
        onmouseover="document.images.next.src='button_next_h.gif'" 
        onmouseout="document.images.next.src='button_next.gif'"><img name="next" src="button_next.gif" border="0" alt="Next topic" title="Next topic" /></a>
        
   </td>

   
   
   
   
   

     
   <td id="print-button" align="center" width="20" class="idnav" valign="bottom">
     <a href="javascript: print();" 
     onmouseover="document.images.printbutton.src='print_h.gif'" 
     onmouseout="document.images.printbutton.src='print.gif'"><img name="printbutton" border="0" alt="Print this topic" title="Print this topic" src="print.gif" /></a>
   </td>  
     
     

  
   <td id="mail-feedback" align="center" width="20" class="idnav" valign="bottom">
   <a href="#"
        onclick='mailFB_custom();'
        onmouseover="document.images.feedback.src='mail_h.gif'" 
        onmouseout="document.images.feedback.src='mail.gif'"><img name="feedback" src="mail.gif" border="0" alt="Mail us feedback on this topic!" title="Mail us feedback on this topic!" /></a>
   </td>
   
   <td width="4">&nbsp;</td>
  </tr>
<!-- End script navheader version -->

<!-- NoScript version of navheader -->

  <tr id="noScriptNavHead" valign="middle" style="height: auto;"> 
    <td align="left" class="topichead"> 
    <p class="p_Heading1"><span class="f_Heading1">Custom settings</span></p>

    </td>
    <td align="center" width="20" class="idnav" valign="bottom">
     <a href="custom_settings_overview.htm">
        <img src="button_prev.gif" border="0" alt="Previous topic" title="Previous topic" /></a>
     
   </td>
   
   <td align="center" width="20" class="idnav" valign="bottom">
     <a href="development_custom_tables_overview.htm">
        <img src="button_next.gif" border="0" alt="Next topic" title="Next topic" /></a>
        
   </td>
   
   
   
  
   

     
     
   <td align="center" width="20" class="idnav" valign="bottom">
   <img border="0" alt="JavaScript is required for the print function" title="JavaScript is required for the print function" src="print_d.gif" />
   </td>
     
     
   
   <td align="center" width="20" class="idnav" valign="bottom">
   <a href="mailto:support@kentico.com?subject=Documentation%20feedback&body=Ref%20ID:%20custom_settings_main%0D%0D"><img src="mail.gif" border="0" alt="Mail us feedback on this topic!" title="Mail us feedback on this topic!" /></a>
   </td>
   
   <td width="4">&nbsp;</td>
  </tr>

<!-- End noscript navheader version -->
  </table>
<div id="autoTocWrapper"></div>
</div> 

<div id="idcontent"><div id="innerdiv">
<!--ZOOMRESTART-->
<p>On this page, you can see the category menu together with the category tree, and the right part contains the contents of the selected category.</p>
<p>&nbsp;</p>
<p class="p_Comment"><span class="f_Comment">From the category menu, you can create a new category using the </span><img src="addnewcustomsettingscategory.png" width="13" height="13" border="0" alt="AddNewCustomSettingsCategory"><span class="f_Comment"> </span><span class="f_Comment" style="font-weight: bold;">New category</span><span class="f_Comment"> link, delete a category using the </span><img src="deletecustomsettingscategory.png" width="13" height="13" border="0" alt="DeleteCustomSettingsCategory"><span class="f_Comment"> </span><span class="f_Comment" style="font-weight: bold;">Delete category</span><span class="f_Comment"> link and you can also move </span><span style="font-weight: bold;">Up </span>(<img src="up_uielement.png" width="13" height="13" border="0" alt="Up_UIElement">) and move <span style="font-weight: bold;">Down</span> (<img src="down_uielement.png" width="13" height="13" border="0" alt="Down_UIElement">) the categories.</p>
<p>&nbsp;</p>
<p class="p_Comment">On the <span style="font-weight: bold;">Settings</span> tab, you can create a new group under the selected category using the <img src="addnewsettingsgroup.png" width="13" height="13" border="0" alt="AddNewSettingsGroup"> <span style="font-weight: bold;">New settings group</span> link, and you can also <span style="font-weight: bold;">Edit</span> (<img src="edit.png" width="13" height="13" border="0" alt="Edit">), <span style="font-weight: bold;">Delete </span><span class="f_Comment">(</span><img src="delete.png" width="13" height="13" border="0" alt="Delete"><span class="f_Comment">), </span><span style="font-weight: bold;">Move up </span>(<img src="up.png" width="13" height="13" border="0" alt="Up">) and<span style="font-weight: bold;"> Move down</span> (<img src="down.png" width="13" height="13" border="0" alt="Down">) the groups. Under the selected group, keys can be created using the <img src="newsettingskey.png" width="13" height="13" border="0" alt="NewSettingsKey"> <span style="font-weight: bold;">New settings key</span> link. The keys can also be <span style="font-weight: bold;">Edited</span> (<img src="edit.png" width="13" height="13" border="0" alt="Edit">), <span style="font-weight: bold;">Deleted </span><span class="f_Comment">(</span><img src="delete.png" width="13" height="13" border="0" alt="Delete"><span class="f_Comment">), </span><span style="font-weight: bold;">Moved up </span>(<img src="up.png" width="13" height="13" border="0" alt="Up">) and<span style="font-weight: bold;"> Moved down</span> (<img src="down.png" width="13" height="13" border="0" alt="Down">).</p>
<p>&nbsp;</p>
<p>On the <span style="font-weight: bold;">General</span> tab, you can modify properties of the selected category and you can also, by changing its parent category, move this category under a different category.</p>
<p>&nbsp;</p>
<p><span style="font-weight: bold;">Category properties:</span></p>
<p>&nbsp;</p>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 0px;"><table width="820" cellspacing="0" cellpadding="5" border="0" style="border: none; border-spacing:0px; border-collapse: collapse;">
<tr style="text-align:left;vertical-align:top;">
<td valign="middle" width="29%" style="width:29%; border: solid 1px #000000;"><p>Display name</p>
</td>
<td valign="middle" width="71%" style="width:71%; border: solid 1px #000000;"><p>The name of the category displayed to website administrators.</p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="middle" width="29%" style="width:29%; border: solid 1px #000000;"><p>Code name</p>
</td>
<td valign="middle" width="71%" style="width:71%; border: solid 1px #000000;"><p>The name of the category used in the code.</p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="middle" width="29%" style="width:29%; border: solid 1px #000000;"><p>Icon path</p>
</td>
<td valign="middle" width="71%" style="width:71%; border: solid 1px #000000;"><p>The icon displayed next to the category caption; you can enter either a full relative path beginning with ~ (e.g. <span style="font-style: italic;">~/App_Themes/Default/Images/CMSModules/list.png</span>) or a short path beginning under the <span style="font-style: italic;">Images</span> folder of the current skin (e.g. <span style="font-style: italic;">CMSModules/list.png</span>).</p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="middle" width="29%" style="width:29%; border: solid 1px #000000;"><p>Parent category</p>
</td>
<td valign="middle" width="71%" style="width:71%; border: solid 1px #000000;"><p>The category where this custom category belongs; you can select another parent category to move the custom category under a different category.</p>
</td>
</tr>
</table>
</div>
<p>&nbsp;</p>
<p><span style="font-weight: bold;">Group properties:</span></p>
<p>&nbsp;</p>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 0px;"><table width="820" cellspacing="0" cellpadding="5" border="0" style="border: none; border-spacing:0px; border-collapse: collapse;">
<tr style="text-align:left;vertical-align:top;">
<td valign="middle" width="29%" style="width:29%; border: solid 1px #000000;"><p>Display name</p>
</td>
<td valign="middle" width="71%" style="width:71%; border: solid 1px #000000;"><p>The name of the group displayed to website administrators.</p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="middle" width="29%" style="width:29%; border: solid 1px #000000;"><p>Code name</p>
</td>
<td valign="middle" width="71%" style="width:71%; border: solid 1px #000000;"><p>The name of the group used in the code.</p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="middle" width="29%" style="width:29%; border: solid 1px #000000;"><p>Parent category</p>
</td>
<td valign="middle" width="71%" style="width:71%; border: solid 1px #000000;"><p>The category where this group belongs; you can select another parent category to move the custom group to a different category.</p>
</td>
</tr>
</table>
</div>
<p>&nbsp;</p>
<p><span style="font-weight: bold;">Key properties:</span></p>
<p>&nbsp;</p>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 0px 0px;"><table width="820" cellspacing="0" cellpadding="5" border="0" style="border: none; border-spacing:0px; border-collapse: collapse;">
<tr style="text-align:left;vertical-align:top;">
<td valign="middle" width="29%" style="width:29%; border: solid 1px #000000;"><p>Display name</p>
</td>
<td valign="middle" width="71%" style="width:71%; border: solid 1px #000000;"><p>The name of the key displayed to website administrators.</p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="middle" width="29%" style="width:29%; border: solid 1px #000000;"><p>Code name</p>
</td>
<td valign="middle" width="71%" style="width:71%; border: solid 1px #000000;"><p>The name of the key used in the code.</p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="middle" width="29%" style="width:29%; border: solid 1px #000000;"><p>Description</p>
</td>
<td valign="middle" width="71%" style="width:71%; border: solid 1px #000000;"><p>The text describing the key.</p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="middle" width="29%" style="width:29%; border: solid 1px #000000;"><p>Group</p>
</td>
<td valign="middle" width="71%" style="width:71%; border: solid 1px #000000;"><p>The group where this key belongs; you can select another group to move the key to a different group.</p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="middle" width="29%" style="width:29%; border: solid 1px #000000;"><p>Type</p>
</td>
<td valign="middle" width="71%" style="width:71%; border: solid 1px #000000;"><p>The type of the key value; you can choose the boolean, integer, double or string value type. The value entered in <span style="font-style: italic;">Site Manager -&gt; Settings -&gt; Custom settings </span>will be validated against the <span style="font-style: italic;">Type</span> property.</p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="middle" width="29%" style="width:29%; border: solid 1px #000000;"><p>Default value</p>
</td>
<td valign="middle" width="71%" style="width:71%; border: solid 1px #000000;"><p>The default value of the key. Values of custom keys can be reset to default in <span style="font-style: italic;">Site Manager -&gt; Settings -&gt; Custom settings</span> using the <span style="font-style: italic;">Reset these settings to default</span> link.</p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="middle" width="29%" style="width:29%; border: solid 1px #000000;"><p>Validation regex</p>
</td>
<td valign="middle" width="71%" style="width:71%; border: solid 1px #000000;"><p>The regular expression used to validate the entered value.</p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="middle" width="29%" style="width:29%; border: solid 1px #000000;"><p>Control path</p>
</td>
<td valign="middle" width="71%" style="width:71%; border: solid 1px #000000;"><p>The path to the control that will be used to edit the value, e.g. <span style="font-style: italic;">~/CMSFormControls/SimpleCountrySelector.ascx</span>. You can create <a href="http://devnet.kentico.com/docs/6_0/devguide/developing_form_controls.htm" target="_blank" class="weblink">your custom form control</a> and set its path.</p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="middle" width="29%" style="width:29%; border: solid 1px #000000;"><p>Key is only global</p>
</td>
<td valign="middle" width="71%" style="width:71%; border: solid 1px #000000;"><p>If checked, all available sites will share the same custom key settings.</p>
</td>
</tr>
</table>
</div>
<p>&nbsp;</p>
<p>Detailed information about Custom settings can be found at <a href="http://devnet.kentico.com/docs/6_0/devguide/settings_overview.htm" target="_blank" class="weblink">Developer's Guide -&gt; Website settings</a>.</p>
<p>&nbsp;</p>

<!--ZOOMSTOP--> 

<noscript>
<p class="help-url"><b>Help URL:&nbsp;</b><a href="<%HELP_LOCATION%><%DEVNET_PATH_NAME%>/index.html?custom_settings_main.htm" target="_top" title="Right-click to copy the URL of this help topic">
<%HELP_LOCATION%><%DEVNET_PATH_NAME%>/index.html?custom_settings_main.htm</a>
</p>
</noscript>
<script type="text/javascript">
var autoURL = true;
if (autoURL) {
      document.write(getHref("index.html","Help URL:","Right-click to copy the URL of this help topic"));
      } else {
             document.write('<p class="help-url"><b>Help URL:&nbsp;</b>');
             document.write('<a href="<%HELP_LOCATION%><%DEVNET_PATH_NAME%>/index.html?custom_settings_main.htm" target="_top" title="Right-click to copy the URL of this help topic"><%HELP_LOCATION%><%DEVNET_PATH_NAME%>/index.html?custom_settings_main.htm</a>');
             document.write('</p>');
      }
</script>

</div></div> 
</body>
</html>





